/*
 * Copyright (c) 2011 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
 *
 * SPDX-License-Identifier: GPL-2.0-only
 *
 * Author: Manuel Requena <manuel.requena@cttc.es>
 * Author: Marco Miozzo <marco.miozzo@cttc.es>
 */
#ifndef LTE_COMMON_H
#define LTE_COMMON_H

#include "ns3/uinteger.h"

#include <cmath>

// see 36.213 section 8
#define UL_PUSCH_TTIS_DELAY 4

#define HARQ_PERIOD 7

namespace ns3
{

/// Minimum number of carrier components allowed by 3GPP up to R13
constexpr uint32_t MIN_NO_CC = 1;

/// Maximum number of carrier components allowed by 3GPP up to R13
constexpr uint32_t MAX_NO_CC = 5;

/// LteFlowId structure
struct LteFlowId_t
{
    uint16_t m_rnti; ///< RNTI
    uint8_t m_lcId;  ///< LCID

  public:
    LteFlowId_t();
    /**
     * Constructor
     *
     * @param a RNTI
     * @param b LCID
     */
    LteFlowId_t(const uint16_t a, const uint8_t b);

    friend bool operator==(const LteFlowId_t& a, const LteFlowId_t& b);
    friend bool operator<(const LteFlowId_t& a, const LteFlowId_t& b);
};

/// ImsiLcidPair structure
struct ImsiLcidPair_t
{
    uint64_t m_imsi; ///< IMSI
    uint8_t m_lcId;  ///< LCID

  public:
    ImsiLcidPair_t();
    /**
     * Constructor
     *
     * @param a first pair
     * @param b second pair
     */
    ImsiLcidPair_t(const uint64_t a, const uint8_t b);

    friend bool operator==(const ImsiLcidPair_t& a, const ImsiLcidPair_t& b);
    friend bool operator<(const ImsiLcidPair_t& a, const ImsiLcidPair_t& b);
};

/**
 * @brief Parameters for configuring the UE
 */
struct LteUeConfig_t
{
    /**
     * RNTI
     */
    uint16_t m_rnti;
    /**
     * When false means that the message is intended for configuring a new UE
     */
    bool m_reconfigureFlag;
    /**
     * Transmission mode [1..7] (i.e., SISO, MIMO, etc.)
     */
    uint8_t m_transmissionMode;
    /**
     * Srs Configuration index for UE specific SRS, see section 8.2 of TS 36.213
     */
    uint16_t m_srsConfigurationIndex;

  public:
    LteUeConfig_t();

    /**
     * Equality operator
     *
     * @param a lhs
     * @param b rhs
     * @returns true if "equal"
     */
    friend bool operator==(const LteUeConfig_t& a, const LteUeConfig_t& b);
    /**
     * Less than operator
     *
     * @param a lhs
     * @param b rhs
     * @returns true if "less than"
     */
    friend bool operator<(const LteUeConfig_t& a, const LteUeConfig_t& b);
};

/// LteFfConverter class
class LteFfConverter
{
  public:
    /**
     * Convert from double to fixed point S11.3 notation
     *
     * @param val double value
     * @returns fixed point S11.3 value
     */
    static uint16_t double2fpS11dot3(double val);
    /**
     * Convert from fixed point S11.3 notation to double
     *
     * @param val fixed point S11.3 value
     * @returns double value
     */
    static double fpS11dot3toDouble(uint16_t val);
    /**
     * Get minimum fixed point S11.3 value
     *
     * @returns double value for the minimum fixed point S11.3 value
     */
    static double getMinFpS11dot3Value();

    // static const double MIN_FP_S11DOT3_VALUE = -4096;
};

/// BufferSizeLevelBsr class
class BufferSizeLevelBsr
{
  public:
    /**
     * Convert BSR ID to buffer size
     *
     * @param val BSR ID
     * @returns buffer size
     */
    static uint32_t BsrId2BufferSize(uint8_t val);
    /**
     * Convert Buffer size to BSR ID
     *
     * @param val buffer size
     * @returns BSR ID
     */
    static uint8_t BufferSize2BsrId(uint32_t val);

    static int m_bufferSizeLevelBsr[64]; ///< buffer size level BSR
};

/// TransmissionModesLayers class
class TransmissionModesLayers
{
  public:
    /**
     * Transmit mode 2 layer number
     * @param txMode the transmit mode
     * @returns the layer 2 number
     */
    static uint8_t TxMode2LayerNum(uint8_t txMode);
};

/// PhyTransmissionStatParameters structure
struct PhyTransmissionStatParameters
{
    int64_t m_timestamp; ///< in millisecond
    uint16_t m_cellId;   ///< Cell ID of the attached Enb
    uint64_t m_imsi;     ///< IMSI of the scheduled UE
    uint16_t m_rnti;     ///< C-RNTI scheduled
    uint8_t m_txMode;    ///< the transmission Mode
    uint8_t m_layer;     ///< the layer (cw) of the transmission
    uint8_t m_mcs;       ///< MCS for transport block
    uint16_t m_size;     ///< Size of transport block
    uint8_t m_rv;        ///< the redundancy version (HARQ)
    uint8_t m_ndi;       ///< new data indicator flag
    uint8_t m_ccId;      ///< component carrier id

    /**
     *  TracedCallback signature.
     *
     * @param [in] params Value of the PhyTransmissionionStatParameters.
     * @todo The argument should be passed by const reference, since it's large.
     */
    typedef void (*TracedCallback)(const PhyTransmissionStatParameters params);
};

/// PhyReceptionStatParameters structure
struct PhyReceptionStatParameters
{
    int64_t m_timestamp;   ///< in millisecond
    uint16_t m_cellId;     ///< Cell ID of the attached Enb
    uint64_t m_imsi;       ///< IMSI of the scheduled UE
    uint16_t m_rnti;       ///< C-RNTI scheduled
    uint8_t m_txMode;      ///< the transmission Mode
    uint8_t m_layer;       ///< the layer (cw) of the transmission
    uint8_t m_mcs;         ///< MCS for transport block
    uint16_t m_size;       ///< Size of transport block
    uint8_t m_rv;          ///< the redundancy version (HARQ)
    uint8_t m_ndi;         ///< new data indicator flag
    uint8_t m_correctness; ///< correctness of the TB received
    uint8_t m_ccId;        ///< component carrier id

    /**
     *  TracedCallback signature.
     *
     * @param [in] params Value of the PhyReceptionStatParameters.
     * @todo The argument should be passed by const reference, since it's large.
     */
    typedef void (*TracedCallback)(const PhyReceptionStatParameters params);
};

/// DlSchedulingCallbackInfo structure
struct DlSchedulingCallbackInfo
{
    uint32_t frameNo;           ///< frame number
    uint32_t subframeNo;        ///< subframe number
    uint16_t rnti;              ///< RNTI
    uint8_t mcsTb1;             ///< MCS TB1
    uint16_t sizeTb1;           ///< size TB1
    uint8_t mcsTb2;             ///< MCS TB2
    uint16_t sizeTb2;           ///< size TB2
    uint8_t componentCarrierId; ///< component carrier ID
};

/**
 * Implements the E-UTRA measurement mappings defined in  3GPP TS
 * 36.133 section 9.1 E-UTRAN measurements
 *
 */
class EutranMeasurementMapping
{
  public:
    /**
     * converts an RSRP range to dBm as per
     * 3GPP TS 36.133 section 9.1.4 RSRP Measurement Report Mapping
     *
     * @param range the RSRP range value
     *
     * @return the corresponding RSRP value in dBm
     */
    static double RsrpRange2Dbm(uint8_t range);

    /**
     * convert an RSRP value in dBm to the corresponding range as per
     * 3GPP TS 36.133 section 9.1.4 RSRP Measurement Report Mapping
     *
     * @param dbm the RSRP value in dBm
     *
     * @return the corresponding range
     */
    static uint8_t Dbm2RsrpRange(double dbm);

    /**
     * converts an RSRQ range to dB as per
     * 3GPP TS 36.133 section 9.1.7 RSRQ Measurement Report Mapping
     *
     * @param range the RSRQ range value
     *
     * @return the corresponding RSRQ value in dB
     */
    static double RsrqRange2Db(uint8_t range);

    /**
     * convert an RSRQ value in dB to the corresponding range as per
     * 3GPP TS 36.133 section 9.1.7 RSRQ Measurement Report Mapping
     *
     * @param db the RSRQ value in dB
     *
     * @return the corresponding range
     */
    static uint8_t Db2RsrqRange(double db);

    /**
     * Quantize an RSRP value according to the measurement mapping of TS 36.133
     *
     * @param v RSRP value in dBm
     *
     * @return the quantized RSRP value in dBm
     */
    static double QuantizeRsrp(double v);

    /**
     * Quantize an RSRQ value according to the measurement mapping of TS 36.133
     *
     * @param v RSRQ value in dB
     *
     * @return the quantized RSRQ value in dB
     */
    static double QuantizeRsrq(double v);

    /**
     * @brief Returns the actual value of a hysteresis parameter.
     * @param hysteresisIeValue IE value of hysteresis
     * @return actual value in dB, which is IE value * 0.5 dB
     *
     * As per section 6.3.5 of 3GPP TS 36.331.
     *
     * The allowed values for hysteresis IE value are between 0 and 30.
     *
     * \sa LteRrcSap::ReportConfigEutra
     */
    static double IeValue2ActualHysteresis(uint8_t hysteresisIeValue);

    /**
     * @brief Returns the IE value of hysteresis.
     * @param hysteresisDb actual hysteresis value in dB
     * @return IE value of hysteresis in dB, which is actual value * 2, rounded
     *         to the nearest integer
     *
     * The allowed values for hysteresis are between 0 and 15 dB.
     *
     * \sa LteRrcSap::ReportConfigEutra
     */
    static uint8_t ActualHysteresis2IeValue(double hysteresisDb);

    /**
     * @brief Returns the actual value of an a3-Offset parameter.
     * @param a3OffsetIeValue IE value of a3-Offset
     * @return actual value in dB, which is IE value * 0.5 dB
     *
     * As per section 6.3.5 of 3GPP TS 36.331.
     *
     * The allowed values for a3-Offset IE value are between -30 and 30.
     *
     * \sa LteRrcSap::ReportConfigEutra
     */
    static double IeValue2ActualA3Offset(int8_t a3OffsetIeValue);

    /**
     * @brief Returns the IE value of a3-Offset.
     * @param a3OffsetDb actual A3 Offset value in dB
     * @return IE value of a3-Offset in dB, which is actual value * 2, rounded
     *         to the nearest integer
     *
     * The allowed values for A3 Offset are between -15 and 15 dB.
     *
     * \sa LteRrcSap::ReportConfigEutra
     */
    static int8_t ActualA3Offset2IeValue(double a3OffsetDb);

    /**
     * @brief Returns the actual value of an Q-RxLevMin parameter.
     * @param qRxLevMinIeValue IE value of Q-RxLevMin
     * @return Q-RxLevMin actual value in dBm, which is IE value * 2 dBm
     *
     * As per section 6.3.4 of 3GPP TS 36.331.
     *
     * \sa LteRrcSap::CellSelectionInfo
     */
    static double IeValue2ActualQRxLevMin(int8_t qRxLevMinIeValue);

    /**
     * @brief Returns the actual value of an Q-QualMin parameter.
     * @param qQualMinIeValue IE value of Q-QualMin
     * @return Q-QualMin actual value in dB, which is IE value dB
     *
     * As per section 6.3.4 of 3GPP TS 36.331.
     *
     * \sa LteRrcSap::CellSelectionInfo
     */
    static double IeValue2ActualQQualMin(int8_t qQualMinIeValue);

}; // end of class EutranMeasurementMapping

}; // namespace ns3

#endif /* LTE_COMMON_H_ */
